<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="GENERATOR" content="Mozilla/4.76 [en] (Windows NT 5.0; U) [Netscape]">
   <title>Draw Circle/Circular Arc/Circular Wedge</title>
</head>
<body ONLOAD="if(parent.frames[&quot;&quot;])location=&quot;#nowhere&quot;; if(parent.frames[&quot;frm5&quot;])parent.frames[&quot;frm5&quot;].location=&quot;OpcodesHd.html&quot;">
<b><i><font face="Arial">Draw Circle/Circular
Arc/Circular Wedge</font></i></b>
<p>
<hr>
<p><font face="Arial Black"><font size=-1>Purpose</font></font>
<dir>The <b>Draw Circle/Circular Arc/Circular Wedge</b> function draws
either the outline of a circle (or a partial circle) or the interior of
a circle (or partial circle) based on the "Fill Mode" attribute.</dir>
<font face="Arial Black"><font size=-1>Syntax</font></font>
<br>&nbsp;
<center><table BORDER CELLPADDING=9 WIDTH="55%" BORDERCOLOR="#000000" >
<tr>
<td VALIGN=TOP WIDTH="17%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Opcode
format</font></font></font></td>

<td VALIGN=TOP WIDTH="22%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Opcode
[ASCII] (Hex)</font></font></font></td>

<td VALIGN=TOP WIDTH="28%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Operand
Format</font></font></font></td>

<td VALIGN=TOP WIDTH="33%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Comments</font></font></font></td>
</tr>

<tr>
<td VALIGN=TOP WIDTH="17%"><font face="Arial"><font size=-2>Single-byte,
readable operand</font></font></td>

<td VALIGN=TOP WIDTH="22%"><font face="Courier New"><font size=-2>[R] (52)</font></font></td>

<td VALIGN=TOP WIDTH="28%"><b><font face="Courier New"><font size=-2>[&lt;ws>]&lt;I<sub>X</sub>>,&lt;I<sub>Y</sub>>&lt;ws>&lt;I<sub>R</sub>></font></font></b></td>

<td VALIGN=TOP WIDTH="33%"><font face="Arial"><font size=-2>Absolute coordinates.</font></font></td>
</tr>

<tr>
<td><font face="Arial"><font size=-2>Extended ASCII</font></font></td>

<td><font face="Courier New"><font size=-2>(Circle</font></font></td>

<td><b><font face="Courier New"><font size=-2>&lt;ws>&lt;I<sub>X</sub>>,&lt;I<sub>Y</sub>>&lt;ws>&lt;I<sub>R</sub>>&lt;ws>&lt;I<sub>Start</sub>>,&lt;I<sub>End</sub>>[&lt;ws>])</font></font></b></td>

<td><font face="Arial"><font size=-2>Absolute coordinates.</font></font></td>
</tr>

<tr>
<td VALIGN=TOP WIDTH="17%"><font face="Arial"><font size=-2>Single-byte,
binary operand</font></font></td>

<td VALIGN=TOP WIDTH="22%"><font face="Courier New"><font size=-2>[r] (72)</font></font></td>

<td VALIGN=TOP WIDTH="28%"><b><font face="Courier New"><font size=-2>&lt;L<sub>X</sub>>&lt;L<sub>Y</sub>>&lt;UL<sub>R</sub>></font></font></b></td>

<td VALIGN=TOP WIDTH="33%"><font face="Arial"><font size=-2>Full circle,
relative coordinates.</font></font></td>
</tr>

<tr>
<td>-</td>

<td><font size=-2><font face="Courier New">[</font><font face="Arial">Ctrl-</font><font face="Courier New">R]
(12)</font></font></td>

<td><b><font face="Courier New"><font size=-2>&lt;S<sub>X</sub>>&lt;S<sub>Y</sub>>&lt;US<sub>R</sub>></font></font></b></td>

<td><font face="Arial"><font size=-2>Full circle, relative coordinates.</font></font></td>
</tr>

<tr>
<td>-</td>

<td><font face="Courier New"><font size=-2>(92)</font></font></td>

<td><b><font face="Courier New"><font size=-2>&lt;L<sub>X</sub>>&lt;L<sub>Y</sub>>&lt;UL<sub>R</sub>>&lt;US<sub>start</sub>>&lt;US<sub>End</sub>></font></font></b></td>

<td><font face="Arial"><font size=-2>A partial or full circle, relative
coordinates.</font></font></td>
</tr>
</table></center>

<dir><i>X,Y</i>&nbsp;&nbsp; Center point (in logical coordinates) of the
circle to be drawn
<p><i>R</i>&nbsp;&nbsp; Radius (in logical coordinates) of the circle to
be drawn
<p><i>Start, End</i>&nbsp;&nbsp; The angles (in 360/65,536ths of a degree)
that describe a "pie-slice" of the full circle to be rendered; legal values
range from 0 to 65,535</dir>
<font face="Arial Black"><font size=-1>Details</font></font>
<dir>When the "<a href="SetFilMod.html">Fill Mode</a>" attribute is inactive
(the default), the <b>Draw Circle</b> function renders the outline of a
circle based on the current line drawing attributes, which include "<a href="SetColr.html">Color</a>",
"<a href="SetVis.html">Visibility</a>", "<a href="SetLinWgt.html">Line
Weight</a>", "<a href="SetLinSty.html">Line Cap</a>", and "<a href="SetLinPat.html">Line
Pattern</a>."
<p>When the "Fill Mode" attribute is active, the <b>Draw Circle</b> function
renders the interior of a circle in a solid color, based on the Polygon
drawing attributes which include "Color", and "Visibility."
<p>Some of the circle opcodes take <i>Start</i> and <i>End</i> arguments,
which allow a portion of the specified circle to be rendered. This is shown
in figure 1. With "Fill Mode" off, <i>Start</i> and <i>End</i> define a
circular arc, and with "Fill Mode" on, a circular wedge is rendered. The
<i>Start</i>
and <i>End</i> values are integers that represent 360/65,536ths of a degree.<a NAME="Fig10"></a></dir>

<center><img SRC="Image53.gif" height=240 width=360>
<p><i><font face="Arial,Helvetica">Figure 1. Portion of circle rendered
by Start and End arguments</font></i></center>

<p><font face="Arial Black"><font size=-1>Notes</font></font>
<dir>When start and end angles are specified, there are two possible regions
of the circle that can be considered: WHIP! data only considers the region defined
by going from start to end in a counter-clockwise direction.
<p>When "Fill Mode" is active, a visually apparent outlining edge of the
circle is not rendered. The filled <b>Draw Circle</b> function may be followed
by an additional unfilled Draw Circle call to render the desired edge.
For an example and further information, see the "Notes" section of the
<b><a href="DrwPlylnPlygon.html">Draw
Polyline/Polygon</a></b> function.</dir>
<hr>
<hr WIDTH="100%">
</body>
</html>
